home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / bbsbul19.zip / BBSBULL.DOC next >
Text File  |  1992-11-08  |  20KB  |  376 lines

  1.                         A.C. Software BBSBULL
  2.  
  3.  
  4.  
  5. This program does two things.  First it keeps a database of BBSes and
  6. sysops.  (I use it for a Visiting Sysop BBS list.)  Second, it generates
  7. a nicely formatted bulletin listing the BBSes in either alphabetical
  8. order or by area code by BBS name, with Wildcat 3.0 color codes or in
  9. plain text (for printing out or use in other BBS programs).
  10.  
  11. This is a BBS lister so you can put out your own nicely formatted BBS
  12. list AND this also makes a bulletin with Wildcat Color codes in it so
  13. you can have your BBS list (or visiting sysop list) in your Bulletins
  14. section.  Being a database (offline) it's easy to change and add or
  15. delete BBSes!
  16.  
  17. BBSBULL is shareware.  A psaltry 10.00 registration fee will allow me to
  18. keep you current on the lastest version and also, if you want, I'll
  19. customize the colors for you.  There is no difference between the
  20. registered version and this version except a good feeling and maybe your
  21. favorite colors.  I feel a shareware registration should work on the
  22. honor system.  Send registration fee with name and comments to:
  23.  
  24.         A.C. Software Shareware
  25.         P.O. Box 7643
  26.         Phoenix, AZ, 85011-7643
  27.  
  28. Log on our support BBS (see end of docs for number and ad...)
  29.  
  30. INSTALLING BBSBULL:
  31.  
  32. Best to put it on its own directory but if you want to put it in the
  33. WC30 root directory, be sure to keep all the files together.  The
  34. package you received should have:
  35.  
  36.            BBSBULL.EXE  --> the executable program
  37.            BBSBULL.DOC  --> this documentation
  38.            SAMPLE.TXT   --> Sample list of Cheese Whiz Visiting Sysops
  39.                              (text)
  40.             BULL1.BBS   --> Sample list for bulletin with WC30 color
  41.                              codes embedded.
  42.            LISTBBS.DBF  --> Database with one record in it for Cheese
  43.                              Whiz (you DO want that in there, don't you?)
  44.            PRT.EXE      --> Handy printing program for printing out
  45.                            these DOCS.  Type in at DOS prompt:
  46.                              PRT BBSBULL.DOC
  47.            QUES0002.DAT --> Sample BBS visiting sysop questionaire which
  48.                             can be used on a Wildcat! 3.02 BBS or modified
  49.                             with MAKEQUES.EXE
  50.            MAKEBBS.BAT ---> Handy bat file for launching BBSBULL and
  51.                             making an archive of the text file etc
  52.            CONFIG.BAT ----> BAT file for reconfiguring BBSbull...
  53.            WHATSNEW.TXT---> New features in this release of BBSBULL.
  54.  
  55.      PRT BBSBULL.DOC (press {ENTER})
  56.  
  57. And it will print out these docs with page numbers, headers.  You can
  58. put in up to 5 files on the command line with PRT.
  59.  
  60. When you run BBSBULL, it will put up a screen asking you the name of
  61. your BBS for the Title of the Bulletin.  It will ask you if you want the
  62. words "VISITING SYSOP" included in the title of your BBS list. This
  63. allows you to use it as a regular BBS list as well as a Visiting Sysop
  64. BBS list. It also allows you to put in a two line message.  You can skip
  65. the message if you want but must enter the name of a BBS.
  66.  
  67. On this configuration screen, touch {ENTER} on the last field to save
  68. it.  You can move up and down between fields with the arrow keys. (See
  69. the control keys at the end of this documentation for other editing
  70. shortcuts you can use.)
  71.  
  72. If later on, you change your mind and want to configure the program
  73. differently as to BBSname or message, simply erase the "BBB.MEM" file
  74. and then the next time you run BBSBULL, it will allow you to fill in
  75. this information again.
  76.  
  77. The new configuration screen looks like this:
  78. +-----------------------------------------------------------
  79.                     BBSBull Configuration                                
  80.                                                                          
  81.                                                                          
  82.                                                                          
  83.  BBS name    :  CHEESE WHIZ WILDCAT                                      
  84.  Phone number:  (602) 279-0793                                           
  85.  'Visiting Sysop' included in the title?  Y                              
  86.                                                                          
  87.  You can have a one or two line message at the end of your               
  88.  Bulletin.  (See included samples for suggestions..)                     
  89.  Type in a message for bottom of bulletin:                               
  90.  >  Sysops, don't forget to fill out Questionaire #2 to get on this list!
  91.  >  (People have killed for less! <G> )                                  
  92.                                                                          
  93.  Output bulletin filename (no extension):  BULL1                         
  94.  Path for bulletin output file          :  C:\WC30\BULL\                 
  95.  Name of Sister BBS <to highlight>      :  YOYODYNE                      
  96.  Letter for User Flag <ENTER for none>  :  C                             
  97.  Description of User Flag <text to appear at top of list>:               
  98.  
  99. +-----------------------------------------------------------------
  100.  
  101. Following are explanations of the different things you can configure:
  102.  
  103. BBSNAME:  The name of your BBS the way you want it to appear at the
  104.                 top of the list.
  105.  
  106. PHONE NUMBER: The phone number of your BBS (with the area code). This
  107.                 will appear at the top of your list also.  If you don't
  108.                 wish to put in your phone number, just press {ENTER} at
  109.                 this screen.  It's recommended to put your phone number
  110.                 (of your BBS in) however, as you can distribute this
  111.                 list as a download BBS list and this way, people will
  112.                 see your BBS phone number and you might get more users.
  113.  
  114. MESSAGE: Next is a message which will go at the end of your 
  115.                 or BBS List.  It can be anything you want.  Just type
  116.                 in line one, presse {ENTER} and then type in line 2.
  117.                 (see our sample list!)
  118.  
  119. OUTPUT BBS BULLETIN: This is the name of the file which BBSBULL will
  120.                 generate for you. If you are going to use it as a 
  121.                 Bulletin, it's suggested that you name it as you would name 
  122.                 the bulletin.  For example, my Bulletin is Bulletin
  123.                 #1 so I typed in "BULL1" (without the quotes, of
  124.                 course).  If you are only going to use it for a
  125.                 download file, you can name it anything, of course.
  126.  
  127. PATH FOR BULLETIN OUTPUT FILE: This is the directory you want BBSBULL
  128.                 to write the BBSlist it generates to.  This enables
  129.                 you to automatically replace an older version of the
  130.                 list with a newer version and write it to the proper
  131.                 directory.  Since I offer my BBS list as a bulletin
  132.                 AND a file download, I write the files to the BULL
  133.                 directory and then, have a bat file (which I will
  134.                 talk about later) ARJ the TEXT version of the BBS
  135.                 List and copy it to the BBSLIST file download
  136.                 directory.  Type in the entire path, Drive and all.
  137.                 (see the sample above).
  138.  
  139. NAME OF SISTER BBS TO HIGHLIGHT:  Most of us have a favorite or 
  140.                 sister BBS which we would like people to notice.
  141.                 This new feature in BBSBULL will show the sister
  142.                 BBS we specify here, as being in purple, 
  143.                 regardless of what software they are running.
  144.                 If you don't have a sister BBS, just press 
  145.                 {ENTER} here.  No problem.  Also, you don't have
  146.                 to put the entire name in.  You can put part
  147.                 of the name but make sure it's a unique part.
  148.                 If you want to highlight CHEESE WHIZ WILDCAT!
  149.                 BBS (a GOOD choice! <G>), you can just type
  150.                 in CHEESE and that would enough to make BBSBULL
  151.                 catch on when it came to Cheese Whiz that it
  152.                 should highlight it.
  153.  
  154. LETTER FOR USER FLAG: This is another new feature.  You can add a
  155.                 flag of your own to the flags which are built into
  156.                 the program and which display after each BBS. The
  157.                 built in flags are A=Adult section, O=Offline Reader
  158.                 Door (like a QWK door) and G=online Games.  In this
  159.                 spot, say you want to highlight all the BBSes which
  160.                 are high speed access (like 9600 and up).  You might
  161.                 put an "H" in this spot.  Or say you want to show all
  162.                 the BBSes which run ANET.  Now, you CAN'T use an A 
  163.                 because that's used already.  You could use an "N"
  164.                 however.  As you can see in the sample, in my BBSlist
  165.                 I have flagged all the BBSes running the Catholic
  166.                 Information Net.
  167.  
  168. DESCRIPTION OF USER FLAG:  This is the description which will appear
  169.                 at the top of your list.  Make it as short as you
  170.                 can without making it difficult to understand.  See
  171.                 above for sample on mine...
  172.  
  173. And that's all... when you get to this point, you can arrow up and 
  174. change anything you want.  Or if you think you are done, just press 
  175. {ENTER} on the 'Description of user flag' spot and you will go into 
  176. the program.  Remember, anytime you want to reconfigure, just run 
  177. the convenient bat file, CONFIG and it will put up this screen again!
  178.                                 
  179.  
  180. USING BBSBULL:
  181.  
  182. This program has everything to do on one screen and you don't go to
  183. separate menus to do things like other programs .....    You see
  184. the "file window" on the screen which is like a list.  If you want
  185. to browse through it, you can press the UP or DOWN arrow keys or you
  186. can go a screen down by pressing the PgDn key and a screen up, by
  187. pressing the PgUp key.  You can go to the END of the file by holding
  188. down the CTRL key and tapping the PgDn key.  You can go to the TOP 
  189. of the file by holding down the CTRL key and tapping the PgUp key.
  190.  
  191. The light bar on the screen tells you what record you are on.  If you
  192. want to EDIT a record, move the light bar that THAT record and press
  193. the RETURN [or ENTER] key.  You will see a window appear on the screen
  194. and you can change anything on the record you want.  If you decide to
  195. not make any changes or don't want to save the changes you made, just
  196. press the ESCape key and the record will remain the same as it was
  197. before.  Pressing F2 or RETURN on the last field will write the changes
  198. you have made to the file.
  199.  
  200. To ADD a record to the file, press the INSert key.  Just fill in the
  201. blanks in the window which appears on the screen and then, when done,
  202. press RETURN [or ENTER] on the last field, or press F2.  Press ESCape
  203. if you change your mind about ADDing a new record.  Now if you want 
  204. to flag that BBS with the flag you defined in the configuration, you
  205. need to put a # sign right after the BBS name.  Like if you wanted 
  206. to highlight all the BBSes running ANET, you would put in Cheese 
  207. Whiz as "Cheese Whiz Wildcat#".  Don't worry, the "#" sign won't 
  208. show up on your list.  It just tells BBSBULL to put that flag on 
  209. the end of the other flags for this particular BBS. There is a 
  210. reminder line about this special flag incase you forget with 
  211. character to use.  I needed that reminder line for ME since I 
  212. forget it every time! :-)
  213.  
  214. DELETING or removing a record is a two part process.  First, you press
  215. the DELete key and select "Delete" from the little menu which pops up.
  216. It will mark the record which the light bar is on as a DELETED record.
  217. If you change your mind and don't wish to DELETE that record, then,
  218. press the DELete key again and you will see that the word, "Delete",
  219. has been replaced with "UNdelete" <because the record is already deleted.>
  220. Select "Undelete" and the record will be UNmarked as deleted.  If you
  221. HAVE deleted the correct record, then you need to take the second step.
  222. You need to get rid of the record forever.  This you do by pressing the
  223. DELete key again, and selecting "PACK" from the menu.
  224.  
  225. Sometimes you might want to find a record really fast or sort the file
  226. in a different order.  You use the SEARCH option for this.  Press F5
  227. <function key 5> and you will a red box pop up with three blank fields
  228. in it.  Fill in the field you want to search on and it will then, do an
  229. indexed search on that field.
  230.  
  231. You can search on sysop name (first name first), BBS name or Area
  232. code/phone number.
  233.  
  234. You can type in the first part of the BBS name, Sysop's first name or
  235. just the area code and it will put you either on the correct record if
  236. only one record satisfies the search word you put in, or on the first
  237. record which fits, or if there is NOTHING like it in the file, it will
  238. put you right after the place where it WOULD be if it were in the file.
  239.  
  240. If you fill in all three fields for the search, BBSBULL will search 
  241. on the first field it comes to which is filled... which in this 
  242. case would be BBSNAME.  So if you want to search under SYSOP, leave 
  243. the BBSNAME field blank.
  244.  
  245. Now, the file is ordered contigent on what you searched on.  Like if you
  246. searched on the BBSname, you will see the file is in the order of the
  247. BBSname.  If it is NOT in the right order after you searched or if you
  248. searched for something you knew was in the file and it didn't go to it
  249. and you checked the spelling and you spelled it right, then touch the
  250. {DEL} key, select "PACK" and that will fix the indexes.  These are B+
  251. tree indexes (complex!) and occasionally, they get confused.
  252.  
  253. MAKING A BBS BULLETIN:
  254.  
  255. To make a bulletin ordered by Area Code by BBS name, press F8 <function
  256. key 8>.  You will see a box which says "WILDCAT 3.0 color codes?".  If
  257. you answer "Y",  (or press {ENTER}) it will print to disk in the same
  258. directory you specified in the configuration, a formatted BBS list 
  259. with Wildcat color codes embedded.  Your user flag is white on 
  260. blue, Wildcat software BBSes are shown in chartreuse and other 
  261. BBSes are shown in white.  The sister BBS you specified (if you 
  262. specified one) is shown in purple.
  263.  
  264. IF you answer "N" to Wildcat 3.0 color codes, it will print to disk an
  265. ascii text list suitable for putting up on a non Wildcat BBS (if anyone
  266. would not want to run the best BBS program for some reason!) or printing
  267. out to printer.  It prints in the same directory you specified for 
  268. the Wildcat bulletin to print.  You can use a bat file to compress 
  269. it, and move it to the proper files directory.
  270.  
  271. Pressing F9 makes a list ordered by BBSname.  It works the same as F8.
  272.  
  273. If you are done using the program and want to quit, Press the ESCape
  274. key.  A small MENU will pop up and give you the choice of Quitting,
  275. or PACKing or returning to the program.  You would PACK if you
  276. search for something that you know is in the file but it doesn't find
  277. it.  Or if you get an error message at the top of the screen about it
  278. being "unable to open NAMEX.NTX" or the like.  Sometimes after a storm,
  279. the indexes may be messed up.  Just select the PACK option from the QUIT
  280. menu and you will be "in business" again.
  281.  
  282. If PACKing doesn't help the indexes, simply go to DOS and delete
  283. all the files with an ".NTX" extension.  Then, when you run the program
  284. again, it will remake all the indexes.  DO NOT DELETE THE FILE WITH
  285. a ".DBF" extension. That's your DATA files!
  286.  
  287. When you are in this program, the DATA FILE is OPEN at all times and
  288. so, BE CAREFUL to NEVER NEVER NEVER leave the terminal while in this
  289. program!!!  If you need to walk away, EVEN FOR A FEW MOMENTS, press
  290. the ESCape key and EXIT this program!  ALSO, be SURE to make REGULAR
  291. backups with FULLBAK or FASTBACK.  Taking this care may save you work
  292. later!
  293.  
  294. The following Control Keys work while adding or changing a record
  295.  
  296.       CTRL and y: this will clear out a field in the record or delete a
  297.                   line in a comment.
  298.       CTRL and f: moves one word to the right.
  299.       CTRL and a: moves one word to the left.
  300.       CTRL and t: deletes the word the cursor is on.
  301.       END <key> : moves to the END of the line.
  302.       HOME <key>: moves to the beginning of the line.
  303.  
  304.       F2 (function key 2) : always exits and saves to disk
  305.      {ESC} (the ESCAPE KEY) always exits WITHOUT saving.
  306.  
  307. HINTS:  I use BBSBULL in conjunction with the fine Wildcat utility, 
  308. QUESVIEW.  I view questionaire #2 and quickly copy the answers (you 
  309. can print these out if you have a printer.  Quesview will show you 
  310. the latest entries into the questionaire.  Now, having them printed 
  311. out or copied down, you can quickly fill out the fields and enter 
  312. them into your database.
  313.  
  314. At first people were looking for something which read the 
  315. Questionaire.  I thought long and hard about this but there are 
  316. problems with reading the questionaire every time.  What do you do 
  317. if a BBS changes or goes down?  (which happens almost on a weekly 
  318. basis)  With a database, change or deletion is very easy and you 
  319. can keep the list up to date.  Also, if you have a program which is 
  320. reading the questionaire, you have to keep that large and growing 
  321. questionaire on your drive... it becomes unwieldy and unmanageable.
  322.  
  323. Another problem in reading the questionaire is you have to use MY 
  324. questionaire. This way you can make up your own, putting the things 
  325. on there which are important to you.  And many users fill out the 
  326. questionaire but they don't want their board on the list because it 
  327. may be private.  Those would be hard to gage if BBSBULL were 
  328. automatically reading the questionaire.  I have not given up on 
  329. making it read the questionaire but have to solve all these 
  330. problems when I do.  For now, it works easy and nice this way, 
  331. especially if you have a BAT file to load it, ARJ the text file and 
  332. move it etc.
  333.  
  334. Here is the bat file I use which is included in this packet.. and
  335. explanations...
  336. ------------------------------------------------------------
  337. @echo off    JUST TURNS OFF THE ECHOING OF DOS COMMANDS
  338. echo ... put backup disk in the a drive..CTRL-C to abort or
  339. pause THIS BAT FILES MAKE A BACKUP TO A DRIVE SO MUST HAVE DISK IN DRIVE
  340. d:    I STORE MY BBSBULL ON THE D DRIVE.  THIS GOES THERE.
  341. cd \bbsbull  GOES TO THE PROPER SUBDIRECTORY
  342. bbsbull      LAUNCHES THE PROGRAM
  343. copy d:\bbsbull\listbbs.dbf a:\  AFTER I GET OUT OF PROGRAM, COPIES FILE
  344.                                  TO A DRIVE.
  345. c:           BACK TO C DRIVE WHERE WILDCAT IS.
  346. cd bull      TO BULLETINS DIRECTORY
  347. arj a cheesbbs bull1.txt  COMPRESSES THE TEXT FILE I MADE WITH ARJ
  348. copy bull1.txt d:\non_ibm\cheesbbs.txt  COPIES TO THE RIGHT DOWNLOAD
  349.                                         DIR
  350. copy cheesbbs.arj d:\bbslist\*.*        COPIES ARCHIVE TO RIGHT DIR
  351. copy cheesbbs.arj a:                    COPIES ARCHIVE TO THE A DRIVE
  352. del bull1.txt                           DELETES TEXT AND ARCHIVE FILES
  353. del cheesbbs.arj                        FOR HOUSEKEEPING...
  354. cd \wc30         GOES TO DIRECTORY WHERE I WILL LAUNCH WILDCAT.
  355. ------------------------------------------------------------------------
  356. You can modify this batch file to YOUR needs!  (use the I included, not
  357. this... the comments here would make it not run <G>)
  358.  
  359.  
  360. This program was produced at the Phoenix location (and only location) of
  361. A.C.Software, POB 7643, Phoenix, AZ 85011.  For a $10 registration fee,
  362. I will customize the colors and other SMALL changes.
  363.  
  364. Log on our support BBS, CHEESE WHIZ BBS 602-279-0793 running the
  365. awesome WildCAT! software!
  366.  
  367.               +---------------------------------------------+
  368.               |          Another application from           |
  369.               |               A.C. Software                 |
  370.               |                                             |
  371.               |                 (co) 1992                   |
  372.               |              by Sue Widemark                |
  373.               |  Reliability, Quality, speed and service!   |
  374.               +---------------------------------------------+
  375.  
  376.